/*
 * Copyright (c) 2007-2020 西安交通信息投资营运有限公司 版权所有
 */

package com.xci.edu.core.dao;

import com.github.lvyanyang.annotation.Paging;
import com.xci.edu.core.entity.EduStudentPeriodDetails;
import com.xci.edu.core.filter.EduStudentPeriodDetailsFilter;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 学员学时明细数据层
 * @author 焦元义 jiaoyuanyi@xci96716.com
 * @since 2020-11-24 15:14:37
 */
public interface EduStudentPeriodDetailsDao {
    /**
     * 新建学员学时明细
     * @param entity 学员学时明细实体
     * @return 返回影响的行数
     */
    int insert(@Param("entity") EduStudentPeriodDetails entity);

    /**
     * 修改学员学时明细
     * @param entity 学员学时明细实体
     * @return 返回影响的行数
     */
    int update(@Param("entity") EduStudentPeriodDetails entity);

    /**
     * 根据主键修改学员学时明细状态
     * @param id     学员学时明细主键
     * @param status 学员学时明细状态
     * @return 返回影响的行数
     */
    int updateStatus(@Param("id") Long id, @Param("status") Boolean status);

    /**
     * 根据主键删除学员学时明细
     * @param id 学员学时明细主键
     * @return 返回影响的行数
     */
    int deleteById(@Param("id") Long id);


    ///**
    // * 根据主键删除学员学时明细
    // * @param id 学员学时明细主键
    // * @param deleteId 删除标识
    // * @return 返回影响的行数
    // */
    //int deleteById(@Param("id") Long id, @Param("deleteId") Long deleteId});

    ///**
    // * 是否存在指定主键的学员学时明细
    // * @param id 学员学时明细主键
    // * @return 如果存在返回true
    // */
    //boolean existxById(@Param("id") Long id);

    ///**
    // * 是否存在指定名称的学员学时明细
    // * @param name 学员学时明细名称
    // * @param excludeId 排除的主键，如果为null则不指定排除的主键
    // * @return 如果存在返回true
    // */
    //boolean existxByName(@Param("name") String name, @Param("excludeId") Long excludeId);

    ///**
    // * 是否存在指定编码的学员学时明细
    // * @param code 学员学时明细编码
    // * @param excludeId 排除的主键，如果为null则不指定排除的主键
    // * @return 如果存在返回true, 否则返回false
    // */
    //boolean existxByCode(@Param("code") String code, @Param("excludeId") Long excludeId);


    /**
     * 根据主键查询单个学员学时明细
     * @param id 学员学时明细主键
     * @return 返回学员学时明细实体
     */
    EduStudentPeriodDetails selectById(@Param("id") Long id);

    ///**
    // * 根据编码查询单个学员学时明细
    // * @param code 学员学时明细编码
    // * @return 返回学员学时明细实体
    // */
    //EduStudentPeriodDetails selectByCode(@Param("code") String code);

    /**
     * 查询学员学时明细列表
     * @param categoryId 科目ID
     * @return 返回学员学时明细列表
     */
    List<EduStudentPeriodDetails> selectList(@Param("categoryId") Long categoryId);

    /**
     * 查询学员学时明细分页列表
     * @param filter 过滤条件
     * @return 返回学员学时明细分页列表
     */
    /*
        allowSortNames = {"courseware_id","courseware_name","student_id","student_name","study_category","ip","sign_in_date_time","sign_out_date_time","period","operate_date_time","operate_date"},
        sortNameMaps = {"courseware_id:courseware_id","courseware_name:courseware_name","student_id:student_id","student_name:student_name","study_category:study_category","ip:ip","sign_in_date_time:sign_in_date_time","sign_out_date_time:sign_out_date_time","period:period","operate_date_time:operate_date_time","operate_date:operate_date"}
    */
    @Paging
    List<EduStudentPeriodDetails> selectPageList(@Param("filter") EduStudentPeriodDetailsFilter filter);
}
